home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1998 April / EnigmA AMIGA RUN 26 (1998)(G.R. Edizioni)(IT)[!][issue 1998-04].iso / classx / x-dve / utils / xfaplay.doc < prev    next >
Text File  |  1998-03-09  |  10KB  |  209 lines
  1. ******************************************************************************
  2. *                                                                            *
  3. *                  eXtra Fast Animation Shell/WB/ARexx Player                *
  4. *                                                                            *
  5. *                © ClassX Development 1996, all rights reserved              *
  6. *                                                                            *
  7. *            ClassX - Via Francesca 463 - I 56030 Montecalvoli (PI)          *
  8. *                       Tel+Fax  +39 587 749206                              *
  9. *                                                                            *
  10. ******************************************************************************
  11.  
  12. ** Introduzione
  13. XFAPlay e' stato sviluppato per mettere a disposizione degli utenti un mezzo
  14. per eseguire animazioni in formato XFA.
  15. Esso e' liberamente distribuibile solo per scopi non commerciali ed e' 
  16. soggetto alle norme che regolano la distribuzione di software nella 
  17. categoria shareware.
  18.  
  19. ** Caratteristiche tecniche
  20. XFAPlay permette di caricare ed eseguire animazioni XFA da disco o da memoria
  21. e puo' essere utilizzato dall'utente da tre ambienti operativi diversi:
  22. Da SHELL (o CLI), da WorkBench o da ARexx.
  23. Per mantenere l'interfaccia utente piu' consistente possibile, i comandi a
  24. disposizione conservano terminologia e prestazioni per tutti gli ambienti
  25. operativi.
  26. XFAPlay utilizza la xfa.library ed e' molto compatto (poco meno di 60kb), in
  27. modo da lasciare piu' spazio in memoria per le animazioni.
  28. L'interfaccia utente e' ancora in inglese per ragioni legate a tempi e costi
  29. di sviluppo, ma risultera' cosi' elementare nell'utilizzo, che nessuno
  30. sentira' il bisogno di una versione italiana (in caso contrario fateci sapere).
  31.  
  32. ******************************************************************************
  33. **                         Ambiente Operativo SHELL                         **
  34. ******************************************************************************
  35.    Si presuppone una minima conoscenza delle modalita' operative della SHELL
  36.    di AmigaDos per un migliore utilizzo di XFAPlay in questo ambiente.
  37. ******************************************************************************
  38.  
  39. Tramite SHELL, XFAPlay si comporta come un normale comando AmigaDos e non
  40. mostra alcuna interfaccia grafica.
  41. Quando XFAPlay viene eseguito senza argomenti, viene mostrata sia la versione
  42. che il prototipo di utilizzo del comando.
  43.  
  44. es:
  45. > XFAPlay
  46. XFAPlay v1.04 (c) ClassX 8-11-1997
  47. Usage: XFAPlay <filename> [Loop|AutoPause|NoWait|WBModeID|Slow|CyberGfx]
  48.  
  49.  
  50. dove:
  51.  <filename>  e' il nome completo dell' animazione XFA (obblibatorio).
  52.  [Loop]      abilita la modalita' di esecuzione in ciclo continuo.
  53.  [AutoPause] abilita la modalita' di esecuzione con pause automatiche
  54.  [NoWait]    disabilita l'attesa del click del mouse all'inizio ed alla
  55.              fine dell'animazione.
  56.  [WbModeId]  forza l'utilizzo di uno schermo di esecuzione con risoluzione
  57.              compatibile con quella del WorkBench (utile per visualizzare
  58.              animazioni XFA su computers non collegati a monitor PAL).
  59.  [Slow]      forza l'esecuzione dell'animazione con una velocita' dimezzata.
  60.              (funziona solo con PlayMem)
  61.  [CyberGfx]  esegue l'animazione su schermi CyberGraphics. L'esecuzione
  62.              potrebbe risultare notevolmente rallentata a causa di
  63.              limitazioni intrinseche di questo standard grafico.
  64.  
  65. Ogni modificatore (parola chiave tra parentesi quadre) e' opzionale ed
  66. abilita la funzione ad esso associata solo se specificato.
  67. Se nessun modificatore viene specificato, la condizione di esecuzione sara':
  68. No Loop, No AutoPause, Wait, No WbModeID
  69.  
  70.  
  71. esempio di utilizzo:
  72. > XFAPlay dh1:x-dve/xfa/prova.xfa LOOP WBMODEID
  73.  
  74. Eseguira' l'animazione "prova.xfa" in modo LOOP su uno schermo compatibile
  75. con quello del workbench.
  76.  
  77. Volendo creare un semplice script che carichi ed esegua automaticamente piu'
  78. animazioni, e' sufficiente creare un piccolo file con ED contenente una
  79. lista di comandi  XFAPlay.
  80. Creando tramite ED il file "show" contenente i seguenti comandi:
  81.  
  82. XFAPlay dh1:x-dve/xfa/introduzione.xfa NOWAIT
  83. XFAPlay dh1:x-dve/xfa/titoli.xfa  NOWAIT
  84. XFAPlay dh1:x-dve/xfa/matrimonio.xfa NOWAIT
  85. XFAPlay dh1:x-dve/xfa/battesimo.xfa NOWAIT
  86. XFAPlay dh1:x-dve/xfa/sigla.xfa NOWAIT
  87.  
  88. (NOWAIT e' necessario se si vuole evitare di dare lo start con il mouse per
  89. ogni animazione)
  90.  
  91. ed eseguendolo con:
  92. > Execute show
  93.  
  94. Si otterrebbe la visualizzazione in sequenza delle animazioni.
  95.  
  96. ******************************************************************************
  97. **                        Ambiente Operativo WorkBench                      **
  98. ******************************************************************************
  99.  
  100. Dopo aver lanciato il programma, cliccando due volte sull'icona, XFAPlay
  101. mostra la propria interfaccia sullo schermo di WorkBench.
  102. La prima cosa da fare per eseguire una animazione e' selezionarne il nome
  103. tramite il bottone "Src" (Source, sorgente).
  104. Una volta che il nome dell'animazione e' stato selezionato, esso verra'
  105. visualizzato nel campo testo accanto al bottone "Src", indicando l'avvenuta
  106. selezione.
  107. In questo caso, l'animazione non e' ancora stata caricata in ram e puo' essere
  108. eseguita solamente da disco.
  109. Questo e' facilmente verificabile, in quanto il bottone "Play Mem" non e'
  110. abilitato, mentre "Play Disk" lo e'.
  111. La funzione di play da disco e' stata introdotta per facilitare il preview
  112. di una animazione senza necessariamente doverla caricare in ram.
  113. Il play da disco, infatti, richiede poca memoria e permette l'esecuzione di
  114. animazioni lunghissime anche se il sistema non possiede abbastanza ram da
  115. caricarle interamente.
  116. Il play da disco, inoltre e' abbastanza accurato e veloce da poter essere
  117. utilizzato effettivamente per il play o il riversamento su nastro, anche
  118. se le animazioni in modalita' 32BitI o 16BitI probabilmente risulteranno
  119. abbastanza "scattose" su macchine lente.
  120. Caricando l'animazione in memoria con "Load XFA", il bottone "Play Mem"
  121. diventa disponibile e basta cliccarlo per eseguire l'animazione.
  122. Anche il bottone "?" diventa attivo, permettendo di ottenere informazioni
  123. sull'animazione correntemente in memoria.
  124. I checkbox presenti nella finestra di XFAPlay, se abilitati agiscono come
  125. segue:
  126.  
  127.  [Loop]      abilita la modalita' di esecuzione in ciclo continuo.
  128.  [AutoPause] abilita la modalita' di esecuzione con pause automatiche
  129.  [NoWait]    disabilita l'attesa del click del mouse all'inizio ed alla
  130.              fine dell'animazione.
  131.  [WbModeId]  forza l'utilizzo di uno schermo di esecuzione con risoluzione
  132.              compatibile con quella del WorkBench (utile per visualizzare
  133.              animazioni XFA su computers non collegati a monitor PAL).
  134.  [Slow]      forza l'esecuzione dell'animazione con una velocita' dimezzata.
  135.              (funziona solo con PlayMem)
  136.  [CyberGfx]  esegue l'animazione su schermi CyberGraphics. L'esecuzione
  137.              potrebbe risultare notevolmente rallentata a causa di
  138.              limitazioni intrinseche di questo standard grafico.
  139.  
  140. Essi sono utilizzati completamente solo per il play da memoria; il play
  141. da disco gestisce solamente il checkbox WbModeID.
  142. Il bottone "Free" (libera) libera la memoria occupata dall'animazione,
  143. rendendo ancora disponibile il bottone "Play Disk".
  144. Si ricorda che per interrompere il play di una animazione da disco, e'
  145. sufficiente tenete premuti i due tasti del mouse contemporaneamente.
  146. Per le modalita' di esecuzione delle animazioni in memoria ("Play Mem")
  147. consultare pag. 100 del manuale di X-DVE.
  148.  
  149. ******************************************************************************
  150. **                        Ambiente Operativo ARexx                          **
  151. ******************************************************************************
  152.  
  153. Come gia' accennato, XFAPlay possiede una interfaccia AREXX per poter
  154. utilizzare animazioni in formato XFA da programmi esterni che non conoscono
  155. tale formato ma che sono compatibili ARexx.
  156.  
  157. La porta AREXX di XFAPlay si chiama "XFAPlay" e prevede i seguenti comandi:
  158.  
  159. XFA_REQSRC <s>         ;Apre il file-requester preimpostandolo con <s>
  160. XFA_SOURCE <s>         ;Imposta il campo "Src" di XFAPlay con la stringa s
  161. XFA_LOAD               ;Carica l'animazione "Src" in memoria
  162. XFA_FREE               ;Libera la memoria dall'animazione
  163. XFA_PLAYMEM            ;Esegue l'animazione da memoria (se e' presente)
  164. XFA_PLAYDISK           ;Esegue l'animazione "Src" da disco
  165. XFA_LOOP      <ON|OFF> ;Imposta il modo loop per il play delle animazioni
  166. XFA_AUTOPAUSE <ON|OFF> ;Imposta il modo autopause per il play delle animazioni
  167. XFA_NOWAIT    <ON|OFF> ;Imposta il modo nowait per il play delle animazioni
  168. XFA_WBMODEID  <ON|OFF> ;Imposta il modo wbmodeid per il play delle animazioni
  169. XFA_SLOW      <ON|OFF> ;Imposta il modo slow per il play delle animazioni
  170. XFA_CYBERGFX  <ON|OFF> ;Imposta il modo CyberGraphics per il play delle animazioni
  171.  
  172. I comandi devono essere impartiti in MAIUSCOLO.
  173.  
  174. esempio di script AREXX:
  175.  
  176. /* script di play da memoria */
  177.  
  178.     options results
  179.     address 'XFAPlay'
  180.  
  181.     XFA_SOURCE "DK3:XFA/ClassX.XFA"
  182.    XFA_LOAD
  183.     XFA_AUTOPAUSE OFF
  184.     XFA_LOOP OFF
  185.     XFA_PLAYMEM
  186.     XFA_FREE
  187.    exit
  188.  
  189. /* end script */
  190.  
  191. Oppure:
  192.  
  193. /* script di play da disco */
  194.  
  195.     options results
  196.     address 'XFAPlay'
  197.  
  198.     XFA_SOURCE "DK3:XFA/ClassX.XFA"
  199.     XFA_PLAYDISK
  200.    exit
  201.  
  202. /* end script */
  203.  
  204. Si ricorda che l'interfaccia ARexx di XFAPlay e' abilitata solo se:
  205. - Il server ARexx RexxMast e' stato lanciato prima di XFAPlay.
  206. - XFAPlay e' stato lanciato da WorkBench.
  207.  
  208. ******************************************************************************
  209.